home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / program / makecpx.lzh / makecpx.txt < prev   
Text File  |  1992-06-22  |  6KB  |  122 lines
  1. -------------------------------------------------------------------------
  2.       Manual MAKECPX version 1.02 (C) Noud van Kruysbergen 18/05/92
  3. -------------------------------------------------------------------------
  4.  
  5. 1. Introduction
  6.  
  7. Atari's with a new TOS version do not use the old Control Panel any more, 
  8. but  XCONTROL  is  delivered with the ST/TT.  This  accessory  can  start 
  9. Control Panel modules,  known as CPX files. These CPX files have to use a 
  10. special format,  and one of the things they need to have is a header with 
  11. information  that XCONTROL uses to show the CPX module in its  selectbox. 
  12. This  header information can not easily be created by a  compiler  and/or 
  13. linker, but has to be build up 'manually', and afterwards concatenated to 
  14. the  program  (or actually,  the program has to be  concatenated  to  the 
  15. header).  Still makes sense? Information about how to create a CPX module 
  16. can be obtained from different sources,  which do not make sense on their 
  17. own, but do provide all the necessary information when combined together. 
  18. The  Atari  ST-STE-TT Profibuch (Jankowski,  Rabich & Reschke)  and  some 
  19. articles in the German ST-Computer magazin did the trick for me.
  20.  
  21. 1.1 Texts
  22.  
  23. XCONTROL wants from the CPX module the following information:
  24. - The name of the CPX module ('CPX Name').
  25. - The text underneath the icon ('Icon Text')
  26. - The CPX identification ('CPX ID')
  27. - The version of the CPX module ('Version')
  28.  
  29. 1.2 Graphics
  30.  
  31. XCONTROL wants the following information concerning the icon:
  32. - The color of the 'CPX Name' text
  33. - The color of the 'Icon Text' text and the icon
  34. - The bitmap of the icon (32*24 pixels)
  35.  
  36. 1.3 Variables
  37.  
  38. XCONTROL  finally  needs information about the status of the  CPX  module 
  39. ('Flags'):
  40. - This CPX module only sets variables once ('Set-Only')
  41. - Execute this CPX module at booting time ('BootInit')
  42. - Load this CPX module into memory ('Resident')
  43.  
  44. 1.4 Definitions
  45.  
  46. Please note the following definitions:  a CPX module is a module that can 
  47. be  used  right away by XCONTROL.  a CPZ module is a CPX module  that  is 
  48. inactivated,  and therefore not loaded by XCONTROL.  A CP module does not 
  49. contain  the header information (yet).  A HDR file at last  contains  the 
  50. header information and nothing else.  Summary: HDR + CP = CPX. I will not 
  51. go  into detail about what all the information means and where it can  be 
  52. used  for,  because  you  have to know that yourself  or  otherwise  this 
  53. program is of no use to you!
  54.  
  55. 2. The program.
  56.  
  57. MAKECPX  creates  all  this information and  allows  different  types  of 
  58. storage.  It is now time to start the program.  All the words  introduced 
  59. between quote-marks in the Introduction section do appear in the  dialog. 
  60. The  CPX Name,  Icon Text,  CPX ID and Version number are editable  in  a 
  61. normal way.  The color numbers can be changed by clicking on the  arrows. 
  62. Remember  that  not all possible 16 colors do make sense in  all  resolu-
  63. tions!  The Flags can be set by clicking on the button after the text  or 
  64. by simply clicking on the text itself. If you want to edit the icon click 
  65. on  the  'Edit' button.  A new dialog will appear with  a  32*24  bitmap. 
  66. Drawing  the icon is rather straightforward.  The color you  are  drawing 
  67. with can be seen in the 'Operators' box. You can shift the icon up, down, 
  68. left  or right,  flip it horizontal or vertical,  invert or clear  it  by 
  69. selecting  the proper buttons.  The color can be changed by  pushing  the 
  70. rigth mouse button.  You can also load or save the icon (as a ICN  define 
  71. file,  which is supported by RCS2.PRG and Degas Elite for  instance).  In 
  72. this dialog the buttons are also selectable by pressing a key:
  73.  
  74. Load : 'L'       |Save : 'S'       |X : 'X           |Y : 'Y'
  75. Up : Up arrow    |Down : Down arrow|Left : Left arrow|Right : Right arrow
  76. Color : C        |Invert : I       |Erase : 0        |Cancel : Undo
  77.  
  78. 'Cancel'  will undo all the drawing done and return to the first  dialog, 
  79. 'Main' will keep the changes (if any) made to the icon.
  80.  
  81. You  can  load the header information from a separate header  ('HDR')  or 
  82. extract it from a CPX module ('CPX').  All the information will be  shown 
  83. and is ready for changes.  After the changes are made or a new header  is 
  84. created it can be saved as a header only ('HDR'),  it can be stored to  a 
  85. CPX  module ('CPX') or a new CPX module can be created out of a  CP  file 
  86. ('PRG -> CPX').  Note that in the latter case the program asks for a  PRG 
  87. file  and not for a CP file as one would expect.  This is mainly  because 
  88. compilers and/or linkers don't know about CP(X)s.  Just create a PRG  and 
  89. MAKECPX will add the header and change the name to CPX.  A new CPX module 
  90. is then born.
  91. Note: N_PCSHEL.PRG is a GEM shell for Pure C which offers the possibility 
  92. to  use other editors (like TEMPUS) with Pure C,  and also  supports  CPX 
  93. modules.
  94.  
  95. 3. About the program
  96.  
  97. MAKECPX  is  written  in  (Pure) C,  and  is  independent  of  resolution 
  98. (although  you'll  have  a  problem  with  the  ST  low  resolution)  and 
  99. independent of processor. The version 1.02 is the first official release; 
  100. version 1.01 is the same except it uses a separate resource file.
  101.  
  102. As far as I know there are no bugs;  the program is programmed in a  very 
  103. neat  way  using GEM conventions where necessary.  I can not  accept  any 
  104. responsibility for the (mis)use of this program however.
  105.  
  106. MAKECPX is a Public Domain program,  meaning that you may copy it and use 
  107. it for free.  If you actually use and like it I would like some reward in 
  108. the  form of a postcard (I will not ask for shareware fees or  money  for 
  109. sources  and the like since I gave up getting rich a long time  ago).  If 
  110. there are any wishes, complaints or remarks please let me know.
  111.  
  112. Have fun.
  113.  
  114. Noud van Kruysbergen
  115. Nijmegen Institute for Cognition and Information
  116. University of Nijmegen
  117. PO Box 9104
  118. 6500 HE Nijmegen
  119. the Netherlands
  120. email:kruysbergen@nici.kun.nl
  121.  
  122.